CIMEL Movie Functions -- Quick Reference Guide

Dynamically load and play an external sound file.
• localStr: path of the mp3 file relative to the folder in which the movie is being developed on the developer's local computer (typically "mp3/<filename>").
• rootStr: path of the mp3 file relative to the root folder (i.e. wwwroot/). This function also stops any other sounds previously playing to avoid sound overlap. A typical path would be "movies/<chapter_name>/<filename>".

Usage example:

loadSound("mp3/screen170.mp3","movies/software_engineering/MP3/screen170_1.mp3");

------------------------------------------------------------
loadMultiSound(localStr, rootStr);

Note: For Advanced Users.
This function behaves the same as loadSound(), except that overlapping sounds are allowed to play simultaneously.

Make the textbox visible.

Hide the textbox.

Displays text in the UI textbox.
Notes:
• This function automatically resizes the UI textbox width to fit the size of str. If the text still overflows then the developer reduce size of str by dropping some words/sentences.
• This function also displays the textbox. (i.e. no need to call displayTextBox()).

Combination of showText() and setTextColor() functions to set the UI textbox color based on personaStr passed and the text string to display in UI textbox.

Set the color of textbox based on the persona letter passed as str. The valid values for str are:
• Professor: str="p"
• TA: str="t"
• Student: str="s"
• Librarian: str="l"
• Prof. Blank: str="b" (for introductory movies only)

Note: For Advanced Users.
Sets the textbox background color to the specified str. This value should be a hex number (e.g. 0x66FFCC) that will correspond to a RGB value color.

Move the textbox to specified x and y.

Move the textbox to the CIMEL standard default position (x=144 and y=416).

Set a particular background color. If the movie clip, "main background" is present in the movie, the developer will be able to see the background on their local computer when the movie is tested.
The valid values for the input string are:
• "white" = default content screen
• "chapT" = chapter title screen
• "inq" = inquiry-based exercise
• "inter" = interactive screen
• "prog" = programming assignment
• "sum" = summary screen

Jump BACKWARD by the number 'n' movies in the menu relative to the current position in the menu.

Jump FORWARD by the number 'n' movies in the menu relative to the current position in the menu.

Jump to the index number 'number' movie directly in the menu relative to the starting of menu. Remember first movie in menu has index number 0 (zero).

This function call should be made in each movie at the logical end of the movie.